home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / DEMON / UTILS / BUD.ARC / ReadMe < prev   
Text File  |  1996-06-12  |  3KB  |  97 lines
  1. Identification
  2. ==============
  3.  
  4. This is BUD - "Batch UuDecoder", written by Kevin F. Quinn
  5. First public release - version 0.10, 12th June 1996
  6.  
  7. This product consists of the following files:
  8.  
  9.   ReadMe    (This file)
  10.   bud       (The compiled application)
  11.   MakeBUD   (Makefile)
  12.   c.main    (Source file)
  13.   c.bud     (Source file)
  14.   h.bud     (Source file)
  15.  
  16.  
  17. Copyright
  18. =========
  19.  
  20. This product Copyright (C) 1995,1996 Kevin F. Quinn.  All rights
  21. reserved.  The product is supplied "as is" with no warranty or
  22. implied fitness for purpose.  Use entirely at your own risk.
  23.  
  24.  
  25. License
  26. =======
  27.  
  28. This product is Freeware.  Permission is hereby granted to use,
  29. copy and distribute the product intact for any purpose without
  30. fee.
  31.  
  32.  
  33. Installation
  34. ============
  35.  
  36. Copy the file "bud" into your library directory.  Use it from
  37. the command line (hit F12 or use a task window - CTRL-F12).
  38.  
  39.  
  40. Syntax
  41. ======
  42.  
  43. *Bud decodes one or more files containing uuencoded data, taking
  44.     account of multiple-part headers in network news style.
  45.  
  46. Syntax: BUD [<options>] <file spec> [<file spec> [<file spec>...]]
  47. Options:
  48.   -v    Verbose messages on
  49.   -d    Debugging on
  50.   -w    Write new ordered file (don't uudecode)
  51.  
  52. Decodes to &.oupt.bud<n>.*
  53. Filenames "." changed to "/", truncated to 10 characters; files
  54. already existing are not overwritten and duplicate filenames are
  55. resolved by overwriting initial characters to hack out ambiguity. 
  56. Writes mapping from original filename to hacked filename to
  57. &.outputref.
  58.  
  59.  
  60. For example:
  61.  
  62.    bud -v Batch1 Batch2 Batch3
  63.  
  64. If you're using !Newsbase to download news and mail, then you
  65. can find the raw batches in !Newsdir.Newsbase.debugnews and
  66. ...debugmail.  Try the following:
  67.  
  68.    Set NBS$Path <News$Dir>.Newsbase.debugnews.DemNews.
  69.    bud -v NBS:0405220312 NBS:0406182345
  70.  
  71. and so on.
  72.  
  73.  
  74.  
  75. Rationale, miscellaneous comments
  76. =================================
  77.  
  78. OK; rationale - to decode multipart UUEncoded binaries regardless
  79. of order of arrival.  Not much else, really.
  80.  
  81. Assumes a "#! rnews " style news batch.  Sorts articles according
  82. to newsgroup, from and date headers, which should almost always
  83. work - it's extremely unlikely that posters of binaries will post
  84. different parts in the wrong order (although of course it's quite
  85. likely that they arrive in the wrong order).
  86.  
  87. Source code is provided, for the paranoid to build their own
  88. binary (requires OSLib) or for nosey people to see how weird
  89. people like me get along with 'C' :)
  90.  
  91. Work the rest out for yourself.  Any problems, comments etc. feel
  92. free to email me at kevq@banana.demon.co.uk.
  93.  
  94. Kev.
  95.  
  96. Dated 12th June 1996
  97.